home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr13 / mmconv10.zip / MMCONV10.DOC next >
Text File  |  1993-06-13  |  8KB  |  189 lines
  1.     MMCONV  version 1.00
  2.  
  3.     MMCONV is designed to be used by those of us who frequent recipe
  4. conferences on BBSes and use MealMaster.  Often people enter intriguing
  5. recipes that are not in MM format.  This program avoids some of the
  6. drudgery of typing such recipes in by hand or manually reformatting them.
  7.  
  8.     MMCONV 1.00 is designed to convert free-form recipes or recipes
  9. formatted for other recipe databases to MealMaster format with minimal
  10. manual effort.  The MM format is:
  11.  
  12.                units     measure        ingredients
  13.    Col 1:       1-7        9-10           13-39
  14.    Col 2:      42-48      50-51           54-81
  15.  
  16.     MMCONV knows the standard MealMaster measurement abbreviations and uses
  17. them.  I did not know small, large, and pinch had standard abbreviations,
  18. but they do.
  19.  
  20.     MMCONV 1.00 detects the start and end of recipes in three different
  21. ways:
  22.  
  23.         Start of recipe:
  24.  
  25.                 --MM
  26.                 -Begin Recipe Export-            (QUIKBOOK)
  27.                 Recipe Via Compu-Chef
  28.  
  29.         End of recipe:
  30.  
  31.                  ---
  32.                  -End Recipe Export-
  33.                  Recipe Via Compu-Chef
  34.  
  35.     The program itself provides a brief help screen if run without an input
  36. file:
  37.  
  38.    version 1.00 Meal-Master recipe formatter by Rodney Grantham
  39.  
  40.  Usage: MMCONV infile [outfile]
  41.  
  42.     infile - contains recipes not in Meal-Master format
  43.     outfile - where to write Meal-Master format recipes
  44.               by default:  MMmmdd
  45.    (Recipes already in MM format are placed in output file)
  46.  
  47.  Some manual pre-processing may be required:
  48.     QUIKBOOK & COMPU-CHEF headings & footers are handled.
  49.      Mark other recipes with --MM at start
  50.            and ---  at end of the recipe.
  51.     Categories are picked up if headed Categories:, Keywords:
  52.       or Cat: (the last is for adding your own category info).
  53.     If none of above is found, Category: Main dish is put in.
  54.     Servings: 1 is always put in the recipe.
  55.     A line of more than 45 characters with no 3 space break
  56.       in it is assumed to be the first direction line.
  57.  
  58.     If a recipe does not have a QUIKBOOK, COMPU-CHEF, or MealMaster header
  59. and footer, it must be manually marked.  Put --MM at the top and at least
  60. 3 dashes (---) at the bottom.  Both of these must be aligned with the left
  61. margin.  DO NOT add a MealMaster format header to a non-MM recipe.  This
  62. recipes are copied as is.  A QUIKBOOK or COMPU-CHEF header could be used
  63. to mark a recipe, but the --MM and --- are fewer characters.
  64.  
  65.     MMCONV will handle a missing footer.  It will be stopped by the next
  66. header.  However, this may cause the inclusion of extra stuff such as
  67. taglines and message header information in some cases.  In Meal-Master
  68. format recipes, a flag message about Unexpected End of Recipe is placed at
  69. the end of the recipe to alert you to check for a problem.
  70.  
  71.     The MMCONV program will split lines that are too long for the basic MM
  72. format.  If these lines are in column 2, there will be a '-' inserted in
  73. column 1 if it would otherwise be blank.  This is required to force MM to
  74. treat the 2nd column as a separate column.  Without this, MM thinks it has
  75. a single line of input which is too long.
  76.  
  77.     Occasionally recipes have commentary between the title and the
  78. ingredients.  You must manually move these into the direction section of
  79. the recipe or delete them for MMCONV to process the recipe correctly.
  80.  
  81.     MMCONV will recognize categories headed with all the following in any
  82. combination of upper or lower case and format them for MM:
  83.  
  84.          Category:
  85.          Categories:
  86.          Keywords:
  87.          Cat:
  88.  
  89.     Servings will always be set as 1.  Serving information in the recipe
  90. will be skipped.  My experience is that such is rarely present and
  91. therefore no logic to process it was included.
  92.  
  93.     A line of more than 45 characters with no space at least 3 blanks wide
  94. (normally occurs between columns or numbers and measurements and
  95. ingredients) are treated as the first direction line.  All subsequent lines
  96. are treated as directions.
  97.  
  98.     If your first direction is short, e.g., Preheat oven 350, it will be
  99. treated as an ingredient.  You can either reformat the recipe to make the
  100. line longer (add on the subsequent line, for example) or manually adjust
  101. this.
  102.  
  103.     If the recipes are read from QWK or BlueWave messages, the From: and
  104. Date: info is placed at the end of the recipe:
  105.  
  106.   From: NANCY GOLDEN                    Date: 09-21-92
  107.  
  108. If there are no message headers detected, the following is used instead:
  109.  
  110. Converted by MMCONV vers. 1.00
  111.  
  112.     If there is a mixture of headed messages and recipes, the message
  113. header information will affect more recipes than the one associated with
  114. it.  Basically, the credit information from it will carry on till the next
  115. header is found.
  116.  
  117.     My approach to using MMCONV is to mark the recipes and then format the
  118. input file with MMCONV.  I then examine the output recipes.  Any recipes
  119. that were not correctly processed, I tweak in the input file and then
  120. reprocess the input file .  This process repeats until the recipes look
  121. right to me.  Or until a few manual changes are all that is required.
  122. Typically, only two passes have been required.  You may take several until
  123. you get a handle on what the program expects.
  124.  
  125.     The following is a sample of what the program output looks like:
  126.  
  127. MMCONV rec.tst
  128.  
  129.  AL'S CHOCOLATE TO THE MAX
  130.  DATE BALLS
  131.  FLOURLESS CHOCOLATE CAKE
  132.  RASPBERRY SAUCE
  133.  RASPBERRY FOOL
  134.  RED LOBSTER GARLIC CHEESE ROLLS
  135.  M&M PIZZAS
  136.  CRUNCHY ALMOND STICKS
  137.  PINATA COOKIES
  138.  ST LOUIS' PEANUT BUTTER COOKIES
  139.  ST LOUIS' RUM BALLS
  140.  
  141.  MM0612.1:
  142.  Recipes saved: 11  (already MM: 2)
  143.     Lines read: 276
  144.  Lines written: 302
  145.  
  146.     The recipe titles display as they are extracted.  This is followed by
  147. the output file name and the number of recipes.  The parenthetical count is
  148. the number of these recipes that were found to already be in MM format.
  149. The lines read and written print out at the end.
  150.  
  151.     Like with MMCRDTxx, the default output file name is MMmmdd.n
  152. (current month and day followed by a file number).  If you provide your own
  153. output file name, the file numbering convention is used similarly to avoid
  154. overwriting existing files.  It is supposed to go up to 999 versions, so
  155. there should be little problem with running out.  I have had up to 30+
  156. versions in testing my programs.
  157.  
  158.     I find manually entering recipes a nuisance.  I also found trying to
  159. squeeze odd recipes into MM format very time consuming.  This program took
  160. a while to write.  But I expect to get some value from the time it saves
  161. me.
  162.  
  163.     I expect you will find that it saves you time as well.  If it does, I
  164. would like payment for the program.  I cannot imagine that it does not save
  165. you $5 worth of time if used a few times.
  166.  
  167.     If you want to register and be notified of upgrades, send your name
  168. and address and the BBS name and phone number where you got the program
  169. with $5 to:
  170.  
  171.               Rodney Grantham
  172.               770 Cranberry Tr.
  173.               Roswell, GA 30076
  174.  
  175.     Please include the version number which displays when MMCONV is run
  176. without any parameters.  If there is a newer version, you will be notified.
  177.  
  178.     If you have suggestions send them to the same address.  I can also be
  179. contacted via RIME or I-LINK CUISINE conferences.
  180.  
  181.     If you use the program and don't register, drop me a postcard anyway.
  182. Include any comments and your name and address and BBS name and phone
  183. number where you got the program.  I won't nag you about the money.  I
  184. realize that sometimes people cannot afford $5.  I'd like to track the
  185. spread and usage just out of curiousity.  At least splurge enough to blow
  186. a quarter.  That's real close to freeware.
  187.  
  188.  
  189.